A program sample demonstrating the implementation of a PAP Server using the Open Transport API.
Description
The PAPServerSample demonstrates the use of the Open Transport to create a Printer Access Protocol Server. This sample supports multiple simultaneous connections.
PAPServerSample demonstrates some of the following network programming techniques
1. Implementing a PAP Server which supports multiple handoff endpoints.
2. Using OptionManagement to enable selfsend mode.
3. Using OptionManagement to enable the EOM (End-of-message option).
4. Using OptionManagement to set the default server message.
The sample provides a user option to make the OTServerLimits call and to also dump the packets that are received. Note that by default, the incoming packets are saved to a file called "SavedPAPFileXX". You can launch the server on the same system that you use the client to send data to the client.
Building the Code
This sample was built using the Metrowerks CodeWarrior 11 environment and the Open Transport 1.1.2 SDK interfaces and libraries.
To rebuild the project, open it in CodeWarrior, change the access path as appropriate to point to the Open Tpt Client Developer folder in the OT 1.1.2 (or newer) SDK, and choose Make from the Project menu.
Limitations:
This sample reuires the presence of Open Transport 1.1.2 or greater.
This sample implements some quick and dirty routines to support the PostScript queries which the Apple LaserWriter client issues to determine the printer type and capabilities. The purpose of this sample is not to demonstrate PostScript query processing. Users are advised to use the parsing code as demonstrated in the file PAPPostScriptStuff.c, with care. and to check that the code properly identifies the PostScript queries for their printer and client. For more information on Postscript Language Processing refer to the Adobe Developer Relations Web Site, Technical Notes For Developers
You may incorporate this sample code into your applications without restriction, though the sample code has been provided "AS IS" and the responsibility for its operation is 100% yours. However, what you are not permitted to do is to redistribute the source as "DSC Sample Code"
after having made changes. If you're going to re-distribute the source, we require that you make it clear in the source that the code was descended from Apple Sample Code, but that you've made changes.
Bug Reports:
If you find any bugs, please send them to "devsupport@apple.com" and include "Attn: Rich Kubota" and I will try to address them.
